home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 June / Macworld (1999-06).dmg / Shareware World / Icon Utilities / clip2icns 1.5.1 / Read Me < prev    next >
Text File  |  1999-02-27  |  7KB  |  88 lines

  1. clip2icns 1.5.1
  2. by Mihai Parparita
  3. $10 Shareware
  4. mihai@mscape.com
  5. http://www.mscape.com/
  6.  
  7. Introduction
  8.  
  9. This little utility is designed to help you create 32 bit icons (which are available under MacOS 8.5 and above). Since Apple has chosen (for the time being) not to release an editor, I've created clip2icns to fill that gap. It takes a picture from the clipboard, splits it up into the icon and mask, and either inserts it into a current file or makes a new icon.
  10.  
  11. Usage
  12.  
  13. First a quick explanation on how 32 bit icons work. All of their data is stored in an icns resource, including the 32, 8, 4, and 1 bit versions (you should also old style resources (icl8, ICN#, ics8, etc) for backwards compatibility). When drawing the icon the MacOS takes the icon and uses the mask to display it. Unlike the old masks where you only had two colors, white as transparent and black as opaque, the new 8 bit masks allow you to use grays to have semi-transparency. For example a light gray would make the icon be almost totally transparent, while a dark one would make it almost totally opaque. This semi-transparency can be used to create cool effects, such as translucent icons, drop shadows that look good on any background and anti-aliasing. For some examples of these effects see the clippings in the Goodies folder.
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22. clip2icns creates the icon by taking the clipboard data and splitting it up into different sections. The picture above shows how the 80x32 image is divided up.  If you don't want to you can omit the small version (thus the image size would be 64x32), and the Finder will shrink down the image automatically (although chances are that the result won't look so great). You can also make icons that only have the small version (so the image would be 16x32), but chances are that this is useful only if you make Kaleidoscope schemes.
  23.  
  24. Here are the steps used in creating or modifying icons:
  25.  
  26. 1. Create an 80x32, 64x32 or 16x32 image with your favorite image editor
  27. 2. Paint the icon(s) and mask(s) in their appropriate positions (see the image above)
  28. 3. Select the whole image and copy it to the clipboard.
  29. 4. Open up clip2icns.
  30. 5. Choose either New Icon File… or Open Icon File… from the File menu (you can also drag a file onto the application to insert an icon into it)
  31. 6. Pick a file or choose a spot to save the new icon (depending on which command you chose)
  32. 7. Pick an icon ID if necessary (the other IDs are only use useful for developers of Kaleidoscope schemes).
  33. 8. Click the Insert button and voila, the icon has been created.
  34. 9. There is also an Extract button, for taking the contenst of the current icon and putting them into the clipboard (the opposite of the insert command). This is useful if you want to tweak someone else's icons, or if you want to see how they've done a certain trick.
  35. 10. When you are done with editing the icons click on the Close button to close the current file.
  36.  
  37. Under the Edit menu there is a Preferences… command. You can use this to set a few global preferences.
  38.      • Include old style resources (if any) will make clip2icns look for old style icons (which use icl8, ICN#, ics8, etc resources) and if they're found they will be included into the new icns resource. They will only be displayed if you're at lower bit depths and you're running MacOS 8.5. 
  39.     • Generate old style resources  will create icl8, ICN#, ics8, etc resources. However, chanes are that they will be horribly dithered.
  40.     • Set bits Kaleidoscope-style will set the Purgeable and System Heap bits for the icon. This is only useful if you develop Kaleidoscope schemes.  
  41.     • Name resources will give the resources names (based on the ones that appear in the menu). The only reason why you might want to turn this off is if you want to save a few extra bytes in file size.
  42.     • Dither  when making lower bit-depths This option allows you to turn on and off the dithering (use of a pattern to simulate colors) when making the 8 bit and lower color depths. Although dithered icons tend to look better, there can be higlighting problems when they are used with pre-8.5 systems. 
  43.  • Remember last ID selection  will set the ID selection pop-up menus to the previous selection when opening files, otherwise it will default to -16455.
  44.  
  45. Shareware Info
  46.  
  47. clip2icns is shareware; it is NOT free. If you use clip2icns for more than a few icons you should pay a $10 registration fee. Registrations for clip2icns are handled by the Kagi Shareware service run by Kee Nethery. In addition to cash in various currencies and US dollar checks drawn on US banks, Kagi Shareware also accepts credit card registrations by snail-mail or e-mail (your card number is scrambled). For organizations, they handle invoices and site licenses, too. To register please use the enclosed Register application or register online at http://order.kagi.com/?QEJ. You will receive a registration code from Kagi, and when you enter that and your name in the registration dialog (available from the Apple menu) the reminder will be disabled.
  48.  
  49. Tips
  50.  
  51. If you're confused as to what some of the new system icons are, when using Mihai's utility there is an option under the file menu that allows you to extract an icon to the  clipboard. Make a copy of your System Resource file in your system 
  52. folder, and extract the icons from that. Then once you've tweaked them to  your liking, you can then use the tool to paste them into your scheme.
  53. Billy Martin
  54.  
  55. Version History
  56. 1.5.1 February 27 1999
  57.  - clip2icns should work again under pre 8.5 systems
  58.  - an error message is now displayed if a file that's in use is opened
  59.  - icons with custom IDs should be displayed properly
  60.  
  61. 1.5 February 10 1999
  62.  - interface greatly improved by making insertion dialog movable, and allowing switching to other applications
  63.  - the dialog now stays open after inserting an icon, thus greatly easing the insertion of more than a few icons into the same file
  64.  - new options for enabling/disabling dithering and remembering of the last selected ID
  65.  - file selection dialogs now show all files, including invisible ones
  66.  
  67. 1.1.1 December 7 1998
  68.  - fixed a rare compression bug
  69.  - included a Photoshop Action which takes a layer and its mask and copies them to the clipboard, ready to be imported into clip2icns
  70.  - when Generate Old Style Icons is turned on, icl4 resources are generated too
  71.  - improved keyboard handling in dialogs
  72.  - fixed a sporadic clipboard export bug
  73.  
  74. 1.1 October 31 1998
  75.  - fixed a serious compression bug
  76.  - when you type in an ID in the insertion or export dialogs, that icon will be previewed and the menu will show its name
  77.  - you can now type in any ID you want in the dialog, and the resource will be named properly
  78.  - name generation can be turned off in the preferences dialog
  79.  - old style icons can be generated too (but chances are that they will look horrible)
  80.  - mail and homepage links in the about box are now clickable (Internet Config is required for this)
  81.  - about box should work under 8.1 and lower
  82.  - added a sample translucent icon to the Goodies folder
  83. 1.0 October 20, 1998
  84.  - first public release
  85.  
  86. Future Plans
  87.  
  88. Two words: Icon Editor.